From ec383a238842b5e50a4e8008c6e59ab5b7158dc7 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sat, 22 Feb 2020 18:50:28 -0500 Subject: [PATCH] Add detail to gdk_drag_begin docs Mention that GTK keeps a reference while the drag operation is ongoing. --- gdk/gdksurface.c | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/gdk/gdksurface.c b/gdk/gdksurface.c index 399e40c368..13b0dec48d 100644 --- a/gdk/gdksurface.c +++ b/gdk/gdksurface.c @@ -3587,6 +3587,10 @@ gdk_surface_register_dnd (GdkSurface *surface) * probably want to set up the drag icon using the surface returned * by gdk_drag_get_drag_surface(). * + * This function returns a reference to the GdkDrag object, but GTK + * keeps its own reference as well, as long as the DND operation is + * going on. + * * Note: if @actions include %GDK_ACTION_MOVE, you need to listen for * the #GdkDrag::dnd-finished signal and delete the data at the source * if gdk_drag_get_selected_action() returns %GDK_ACTION_MOVE. -- 2.30.2